home *** CD-ROM | disk | FTP | other *** search
/ Complete Linux / Complete Linux.iso / docs / devel / prolog / read_me.win < prev    next >
Encoding:
Text File  |  1994-06-06  |  5.8 KB  |  175 lines
  1.             SWI-Prolog for Windows
  2.                 Jan Wielemaker
  3.                    06/05/94
  4.  
  5.  
  6. The file pl-win.zip contains SWI-Prolog for  Windows.  It  is  a port of
  7. version 1.8.11 of SWI-Prolog.  SWI-Prolog  runs   in  a simple MS-Window
  8. providing traditional stream-based interaction.
  9.  
  10. Status:
  11. =======
  12.  
  13. Beta test version.  Please report problems to jan@swi.psy.uva.nl.
  14.  
  15.  
  16. Copyright:
  17. ==========
  18.  
  19. SWI-Prolog may be  distributed  freely   for  non-commercial  use.   See
  20. pl\licence for a more complete description of your rights.
  21.  
  22.  
  23. Requirements:
  24. =============
  25.  
  26. 386/486/pentium based PC running MS-Windows 3.1.  SWI-Prolog is compiled
  27. using the WATCOM 32-bit C/C++ compiler and   should run on machines with
  28. and with or without floating point   coprocessor.   Minimum memory usage
  29. will be about 1  MB.   You'll  probably  need   at  least  4  MB  to run
  30. SWI-Prolog under Windows.  Please report your experiences.
  31.  
  32.  
  33. Installation:
  34. =============
  35.  
  36. Unpack the zip file from C:, creating a directory c:\pl.  If you want to
  37. install in another directory, define the   environment variable SWIPL to
  38. point  to  the  main  direcotry.    The    executable   is   located  in
  39. %SWIPL%/bin/pl.exe.  It looks  for   %SWIPL%/startup/startup.pc  for its
  40. startup file and the directory %SWIPL%/library for the Prolog library.
  41.  
  42. Create a `New Program Object' using the Window Program Manager's `new...'
  43. option.  The fields should be:
  44.  
  45.     Description:        SWI-Prolog
  46.     Command Line:        c:\pl\bin\pl.exe
  47.     Working Directory:    The place you work
  48.  
  49. Modify `Command Line' if you installed SWI-Prolog into another directory.
  50.  
  51.  
  52. Configuration of the console dimensions:
  53. ========================================
  54.  
  55. The stream-based console window is a  completely separate library, using
  56. its own configuration info.  It will  look at two environment variables:
  57. "CONSOLE" and the base-name of the running  program ("PL" if you use the
  58. default configuration).  Options in "PL"   overrule  those in "CONSOLE".
  59. Options in "CONSOLE" apply to any application compiled using the console
  60. library.  The options variable should contain a string of the form
  61.  
  62.     <name>:<value>{,<name>:<value>}
  63.  
  64. Where <name> is one of:
  65.  
  66.     <name>    default        description
  67.     sl    200        Number of lines you can scroll back.
  68.                 There is no limit, but the more you
  69.                 specify the more memory will be used.
  70.                 Memory is allocated when data becomes
  71.                 available.
  72.     rows    24        Initial number of lines
  73.     cols    80        Initial number of columns
  74.     x    CW_USEDEFAULT    X-coordinate of the top-left corner.
  75.     y    CW_USEDEFAULT    Y-coordinate of the top-left corner.
  76.                 
  77. You will normally specify this in your autoexec.bat file.  Here is
  78. what I use:
  79.  
  80.     set CONSOLE=sl:600,x:400,y:400
  81.  
  82.  
  83. Windowing and Graphics
  84. ======================
  85.  
  86. SWI-Prolog itself has  no  graphical   capabilities.   Graphics  can  be
  87. provided by the XPCE toolkit, for which   an MS-Windows version is under
  88. development and will soon be  available   for  public  release.  XPCE is
  89. *not* free software.  The licence conditions   neither the price for the
  90. Windows version is decided yet.   Contact xpce-request@swi.psy.uva.nl if
  91. you are interrested.
  92.  
  93.  
  94. Filenames:
  95. ==========
  96.  
  97. All filenames are internally handled in   a Unix compatible format: they
  98. are lowercase, the directories are  separated   with  a '/' and absolute
  99. files are of the form  /<drive>:/...    Filenames  will  be converted to
  100. DOS/Windows format just before invoking the C-library functions.
  101.  
  102. Filename expansion will translate `~' to  the environment variable HOME.
  103. Constructs  of  the  form  $VAR  in    filenames  are  expanded  to  the
  104. corresponding environment variable.  DOS %VAR% is not recognised.
  105.  
  106. The user may specify filenames either using   DOS format or Unix format.
  107. Unix format should be used in source-files that   need to be run both on
  108. the Unix and DOS/Windows version.
  109.  
  110.     
  111. Features and bugs specific to this version:
  112. ===========================================
  113.  
  114.     * Dynamically expanding runtime stacks using a stack-shifter.
  115.  
  116.     * Garbage collection works.
  117.  
  118.     * Fixed C-stack of 128 KB (limits depth of unification and
  119.       various other recursive tasks; does not limit normal Prolog
  120.           recursion).
  121.  
  122.     * GNU-Readline 1.2 based input editor that allows for GNU-EMACS
  123.       like editing of the command line.  This input editor runs on
  124.       top of a simple, still incomplete I/O window.     Features:
  125.  
  126.           * Command history using ^P, ^N
  127.         * Cursor movement using ^B, ^F, etc.
  128.         * Many more; just try the GNU-Emacs bindings!
  129.         * End-of-file is ^D.
  130.         * Completion on files and atoms using TAB, viewing
  131.           alternatives using ESC-?
  132.         * Window may be resized and scrolled.
  133.  
  134.       Bugs:
  135.  
  136.         * Showing matching bracket does not work
  137.         * Resizing the window while the line is wrapped gives
  138.           bad results.
  139.  
  140.     * save/[1,2] and save_program/[1,2] do not work.
  141.  
  142.     * profile/1 does not work.
  143.  
  144.     * load_foreign/[2,5] does not work.
  145.  
  146.     * The statistics/[0.2] reported CPU-time also includes idle time.
  147.  
  148.     * help/1 just dumps it output in the console window.  Should be
  149.       a separate window some day ...
  150.  
  151.     * Control-C cannot be used to break loops.
  152.  
  153.     * Fatal errors will often just cause the window to disappear.
  154.  
  155.  
  156. Boot compilation:
  157. =================
  158.  
  159. The file pl\startup\startup.pc is  a   `Prolog  Intermediate  Code' file
  160. created from the Prolog sources in the   boot subdirectory.  If you want
  161. to change anything there, you can recreate   the  startup file using the
  162. command:
  163.  
  164.     pl.exe -o startup/startup.pc -b boot/init.pl -c boot/load.pl
  165.  
  166.  
  167. Sources:
  168. ========
  169.  
  170. The common source for all platforms is  available using anonymous ftp to
  171. swi.psy.uva.nl,  directory  pub/SWI-Prolog.   The   Windows  version  is
  172. compiled using the 32-bit WATCOM C/C++   compiler (version 9.5).  If you
  173. decide to port it to another compiler  (for example GCC), please forward
  174. me the changes.
  175.